home *** CD-ROM | disk | FTP | other *** search
/ Internet Surfer 2.0 / Internet Surfer 2.0 (Wayzata Technology) (1996).iso / pc / text / mac / faqs.106 < prev    next >
Text File  |  1996-02-14  |  29KB  |  652 lines

  1. Frequently Asked Questions (FAQS);faqs.106
  2.  
  3.  
  4.     contrary, it still isn't funny to followup a flame of one line followups
  5.     with a one line followup. Trust me, you *aren't* the first to think of
  6.     this.
  7. 2.  Anything from or following up to the Person Who Must Not Be Named,
  8.     ``Doctor'' R*ger R*bb*t.  Thankfully, he hasn't found any place
  9.     where he's welcome except alt.tv.tiny-toon, which deserves him.
  10. 1.  Finches.
  11.  
  12.  
  13. IV.  Traps for the unwary.
  14.  
  15. Anyone posting to [ab]Usenet should always check the headers of anything
  16. they are following up to. You might be amazed what you find there.
  17. Newbie baiters (see section II, THUGS) have a great time adding a
  18. Followup-to: line directing copies of your deathless prose to the test
  19. groups (which will echo your posting multiple times to you via mail), or
  20. perhaps worse, to groups full of humorless nutcases like
  21. misc.jobs.offered. Pay attention!
  22.  
  23.   Another trick is the bogus group. The major perpetrator of these,
  24. Roger Carasso, is pretty much off the net (sadly it will most likely not
  25. be permanent), but you'll surely still see groups like
  26. alt.wanted.moslem.gay created for the sole purpose of outraging some
  27. group or another. Expect your indignant posting to these groups to be
  28. digestified and widely reposted for the amusement of clueless morons.
  29. The best defense is to not take yourself or the net seriously. Even
  30. legitimate groups populated by overly enthusiastic people might be so
  31. abused.
  32.  
  33.   Lastly, learn your net names, not user names. It is pitifully easy to
  34. modify just about everything in a news header. If you have any doubts,
  35. check the Path: line against the From: user line. The path line is very
  36. hard to successfully forge and most don't bother because many
  37. newsreaders don't display it unless you save the whole article to a file
  38. and list it out.
  39.  
  40. V.  Staple threads.
  41. If you aren't creative enough to think up an original topic, you _might_ try
  42. one of these. Better yet, don't:
  43.  
  44. -  Short Shameful Confession (and variants). A supposed t.b rite of
  45.    passage. Imagine it as one-handed Truth or Dare. The more you embarrass
  46.    yourself in the fewer words, the better.
  47.  
  48. -  One Line bio. These have for the most part died out, mostly because
  49.    everyone who you might care about (and many you don't) have done one
  50.    already.
  51.  
  52. -  Rictus Hep stories. Sort of like the Sufi character Nasrudin walking
  53.    through Zen koans. That's giving the whole thing way too much credit
  54.    though. *Way* too much.
  55.  
  56. -  100 word stories. Out of fashion for the most part.
  57.  
  58. -  Transformations. The sole property of Mark. Gooley. If you do one,
  59.    shamelessly imitate his style. Find out what it is first.
  60.  
  61. -  Limericks and haiku. The only thing worse than posting one of these is
  62.    getting the meter wrong.
  63.  
  64. -  Pro and Con. This is a new one. It has potential though.
  65.  
  66. Your best bet is to think of something new that nobody's ever seen
  67. before. If you can do that, you'll be welcome in talk.bizarre.
  68.  
  69. VI. Catchphrases never to be used.
  70.  
  71. This is a trick section. No catchphrase, from any source, is ever to be
  72. used. Unless you really want to and don't mind being flamed back to the
  73. stone age. Some catchphrases never to be used:
  74.  
  75. - And that's why I had to kill them all.
  76. - Been there, done that
  77. - By the Holy Claws of Klortho the Magnificent, this IS a fine morning!
  78. - Cut it out, nj
  79. - Cut it out, Roger
  80. - Die, rat bastard
  81. - Go jump in a goddam volcano, you fu**ing cave newt
  82. - [Just about anything] IN BED!
  83. - Smegma rich
  84. - There is no Cabal
  85. - We seem to have a new catchphrase on our hands
  86. - Welcome to talk.bizarre. Now, FU** OFF (TM)
  87. - You are an asshole. Shut the fu** up
  88. - You spelled 'pieces' wrong
  89.  
  90. VII. Folklore.
  91.  
  92. [I don't have enough experience in t.b to do this section properly.
  93. Submissions of BOB stories, particularly odious posters, threads from hell,
  94. stupid breast tricks, etc. will be gratefully accepted at pv@gagme.chi.il.us]
  95.  
  96.         One day, Richard Sexton was walking in the forest when he came
  97.     upon a novice who was spitting up blood.  ``O, novice,''
  98.     said Richard Sexton, ``what is the matter?  Wherefore do you spit up
  99.     your precious bodily fluids?''
  100.  
  101.         ``It is because I am trying to turn myself inside out,'' replied
  102.     the leaking fellow.  ``I believe that when my insides are exposed to
  103.     the air and my outsides are on my insides, my wisdom will encompass
  104.     the universe.''
  105.  
  106.         Sexton tore the novice's arm off and hit him over the head with it.
  107.     At that moment, the novice dropped dead.
  108.  
  109.     (This is a true story. -StL)
  110.  
  111.  
  112.      By the Holy Claws of Klortho the Magnificent, this IS a fine morning!
  113. talk.bizarre Steering Committee                           tbsc@volcano.tbsc.org
  114. Xref: bloom-picayune.mit.edu comp.text:10750 news.answers:4593
  115. Path: bloom-picayune.mit.edu!enterpoop.mit.edu!news.media.mit.edu!micro-heart-of-gold.mit.edu!wupost!uunet!uunet.ca!ecicrl!clewis
  116. From: clewis@ferret.ocunix.on.ca (Chris Lewis)
  117. Newsgroups: comp.text,news.answers,comp.answers
  118. Subject: comp.text Frequently Asked Questions
  119. Summary: Discussions on text processing in general, and troff in particular
  120. Keywords: typesetting troff groff ditroff wysiwyg sgml word desktop dwb
  121. Message-ID: <textfaq_724396940@ecicrl>
  122. Date: 15 Dec 92 05:22:34 GMT
  123. Expires: 12 Jan 93 05:22:20 GMT
  124. Reply-To: textfaq@ferret.ocunix.on.ca (Text FAQ commentary reception)
  125. Followup-To: comp.text
  126. Organization: Elegant Communications Inc., Ottawa, Canada
  127. Lines: 595
  128. Approved: news-answers-request@mit.edu
  129. Supersedes: <textfaq_723187334@ecicrl>
  130.  
  131. Archive-name: text-faq
  132. Last-Modified: Wed Dec  9 02:53:12 EST 1992
  133.  
  134.         Frequently Asked Questions for comp.text
  135.                Chris Lewis
  136.             Nils-Peter Nelson
  137.  
  138. (This list was originally compiled by Jaap Akkerhuis, Dick Dunn, Nick
  139. Haines, Steve Harley, Harro Kremer, Chris Lewis, John Macdonald, Bob
  140. Morris, Nils-Peter Nelson, Chip Rosenthal.)
  141.  
  142. If you have comments or additions, please contact Chris Lewis,
  143. textfaq@ferret.ocunix.on.ca (note Reply-to).
  144.  
  145. | Changes are marked with a "|" in left column.  Many newsreaders
  146. | (ie: rn, trn) allow you to search for them with "g^|".
  147.  
  148. Changes this issue: Psroff is now PL14.  A few minor diddles.
  149.  
  150. Questions discussed:
  151.  
  152. General interest:
  153.  
  154.   GN1. What is the difference between word processing, desktop
  155.          publishing, technical publishing, electronic publishing, etc?
  156.   GN2. Which do I need?
  157.   GN3. What is a markup language?
  158.   GN4. What is SGML? ODA?
  159.   GN5. What is WYSIWYG? Do I need it?
  160.   GN6. What is PostScript?
  161.   GN7. What is TeX?
  162.   GN8. What are some popular Desktop Publishing packages?
  163.   GN9. Where can I read more?
  164.  
  165. Specific to troff:
  166.  
  167.   TR1. What is troff? Why are there so many questions about it?
  168.   TR2. How many varieties of troff are there? What are the differences?
  169.   TR3. What are some of the filters for troff output?
  170.   TR4. What other troff printer drivers are there?
  171.   TR5. How do I get my troff to drive my printer?
  172.   TR6. None of the mentioned packages support *my* printer.  Help?
  173.   TR7. How to I embed PostScript in troff?
  174.   TR8. What are fonts?  How do I add fonts?
  175.   TR9. What are width tables?
  176.   TR10. How do I make width tables?
  177.   TR11. What are: pic, eqn, tbl, grap, refer?
  178.   TR12. How do I preview my troff on my screen?
  179.   TR13. I need makedev, but my DWB doesn't come with it.
  180.   TR14. How can I get nroff/troff for DOS?
  181.   TR15. What books can I get about DWB?
  182.  
  183. The discussions below are organized in digest-form, so you may
  184. scan ahead for "^Subject:" to move from one topic to the next
  185. (the ^G command does this in rn), and you may search for "^Subject: GN5"
  186. (for example) to jump to the discussion of a particular question.
  187. (The caret "^" before "Subject" is a convention of regular expressions
  188. that restricts the search to match only at the beginning of a line.)
  189.  
  190. --------
  191. Subject: GN1. What is the difference between word processing, desktop
  192. publishing, technical publishing, electronic publishing, etc?
  193.  
  194. Electronic Publishing is an all-encompassing term that means
  195. using computers (instead of hot lead) to set type for
  196. documents.  Although publishing includes a sequence of
  197. processes right through distribution, EP tends to emphasize
  198. document composition through production of a single master copy.
  199.  
  200. It is helpful to picture a graph with "complexity" along
  201. the X axis and "length" along the Y axis.  Complexity
  202. varies from straight text to footnotes and indexing to
  203. tables to line drawings to gray-scale illustration to
  204. full color.  Length varies from 1 page to 10,000 or more
  205. (better make the Y axis logarithmic!)
  206.  
  207. Word processing dominates the lower left of the graph
  208. (business letters).  Desktop publishing dominates the lower
  209. right (advertising layout).  Host-based text formatters like
  210. troff, TeX and Scribe dominate the upper-left (phone book).
  211. Proprietary systems have traditionally dominated the upper
  212. right (Sears catalog, encyclopedia); these are being supplanted
  213. by hybrids consisting of pieces from the other segments.
  214.  
  215. The middle of the graph is fair ground for everyone but is
  216. increasingly the domain of Technical Publication systems like
  217. Interleaf and FrameMaker.
  218.  
  219. --------
  220. Subject: GN2. Which do I need?
  221.  
  222. Word processors and Desktop publishers are more than adequate
  223. for documents of tens of pages.  Because they are mostly
  224. limited to PC's and Macintosh, they may be impediments in
  225. producing long documents, which would have to be done in
  226. digestible chunks (say, a chapter at a time).  High-end systems
  227. are usually UNIX-based, which means computer power and document
  228. capacity are limited only by how much you want to spend.
  229.  
  230. --------
  231. Subject: GN3. What is a markup language?
  232.  
  233. All formatters need to distinguish the text to be printed
  234. from instructions about how to print; the latter is called
  235. markup.  Procedural markup tells the software what to do
  236. (space down, invoke a macro); generic markup describes the
  237. thing to be printed (heading, cross-reference, etc.)  Troff
  238. and TeX are examples of procedural markups; ODA and SGML
  239. prescribe rules for generic languages; and good macro packages
  240. for troff or TeX make them, more-or-less, generic markup
  241. languages.
  242.  
  243. --------
  244. Subject: GN4. What is SGML? ODA?
  245.  
  246. SGML is the Standard Generalized Markup Language.  SGML is defined
  247. in International Standard ISO 8879:1986.  SGML is a language for
  248. formally describing the structure and contents of documents.  SGML
  249. is also the syntax used by documents so described.
  250.  
  251. SGML is an important move in the direction of separating information
  252. from its presentation, i.e. making different presentations possible
  253. for the same information.  The better macro packages for TeX and
  254. troff attempt to do the same thing.  This is in contrast with WYSIWYG -
  255. see GN5.
  256.  
  257. SGML is more fully discussed in comp.text.sgml.
  258.  
  259. SGML is the name of a directory at the public FTP site ftp.ifi.uio.no
  260. where you can find a (draft) FAQ, a bibliography, and more information.
  261.  
  262. ODA: Office [Open] Document Architecture, takes a similar approach
  263. but stresses blind interchange.  ODA is defined in the multi-part
  264. standard ISO 8613:1988, in the CCITT T.410 series recommendations,
  265. and in ECMA standard 101.
  266.  
  267. --------
  268. Subject: GN5. What is WYSIWYG? Do I need it?
  269.  
  270. What-you-see-is-what-you-get: essential for advertising layout,
  271. but a useless time-waster for a phone book.  WYSIWYG is the
  272. opposite of SGML, in that in SGML you know what something
  273. is (say, a chapter heading) but you don't know what it looks
  274. like; in WYSIWYG you know what it looks like but you don't
  275. know what it is.  The obvious benefit of WYSIWYG is that the
  276. author is aware at all times of the final appearance of the
  277. document; the liability is that the vendor gets to choose the
  278. internal representation of the document, and may not tell you
  279. what it is.  The best trade-off would be a WYSIWYG system with
  280. a well-documented, usable markup language.  We should caution
  281. that few of the self-proclaimed WYSIWYG systems actually show
  282. the exact same thing on screen as you get on a printer:
  283. What You See Is Sort Of Like What You Get.  When 300 dpi,
  284. 17 inch terminals are common true WYSIWYG will be practical.
  285.  
  286. --------
  287. Subject: GN6. What is PostScript?
  288.  
  289. PostScript is a language for output devices.  It does for output
  290. devices what Unix does for processors, viz., it allows a common
  291. software interface despite differences in hardware platform.
  292. PostScript controllers exist for paper printers from 4 pages
  293. per minute up to 92 ppm, from 300 dots per inch to over 6000 dpi
  294. typesetter, and for film recorders, color printers and X Window
  295. terminals.  Without PostScript, every text formatter has to
  296. understand the idiosyncrasies of every vendor's hardware.
  297. See comp.lang.PostScript for more.  PostScript is a registered
  298. trademark of Adobe Corporation.
  299.  
  300. --------
  301. Subject: GN7. What is TeX?
  302.  
  303. TeX is a batch formatter similar to troff developed by Don Knuth
  304. at Stanford.  It is most popular in universities and is freely
  305. traded because of the lack of licensing restrictions. ArborText
  306. sells a commercial version for big and small (ie PC's) machines.
  307. There are various versions for PC-class machines. LaTeX (Leslie
  308. Lamports version of TeX) is a more friendly version of the same
  309. formatter. It does for TeX what macros does for troff.  See
  310. comp.text.tex - which contains a FAQ.
  311.  
  312. Oh, and to save yourself sounding like an idiot, the "eX" in "TeX"
  313. is pronounced as in "deck", not "sex".
  314.  
  315. --------
  316. Subject: GN8. What are some popular Desktop Publishing packages?
  317.  
  318. Aldus practically invented Desktop publishing with "PageMaker".
  319. Ventura is the largest selling of the high-end PC packages.
  320. WordPerfect and Word are lower in functionality but less
  321. expensive and exist on both DOS and Macintosh.
  322. See comp.text.desktop for more information. Interleaf
  323. and FrameMaker are workstation-based and are higher in
  324. price and functionality, and require more substantial
  325. machine resources, but give you more in return.  FrameMaker
  326. is now available for Windows 3.1, giving transportability
  327. between the DOS/Windows, Mac and UNIX world.  See comp.text.desktop,
  328. comp.text.frame and comp.text.interleaf.
  329.  
  330. --------
  331. Subject: GN9. Where can I read more?
  332.  
  333. Publish!, Business Publishing and Seybold Report are all
  334. excellent journals for keeping up to date.  There are
  335. books devoted to most of the major packages, too many
  336. to mention here.
  337.  
  338. Richard Rubinstein's book "Digital Typography", Addison-Wesley
  339. is apparently a readable book that goes into the details of
  340. composition systems, fonts and reproduction.
  341.  
  342. --------
  343. Subject: TR1. What is troff? Why are there so many questions about it?
  344.  
  345. Troff is one of the oldest text formatters in existence. Because
  346. it was distributed as part of the Unix operating system for
  347. many years, it is by default on several hundred thousand machines,
  348. far more than any other Unix text formatter.  It originated
  349. in AT&T Bell Laboratories in 1971 and its author was Joseph
  350. Ossanna.  Its legitimate father was a program called runoff,
  351. written at MIT in the 1960's.
  352.  
  353. Because there is no comp.text.troff, additional questions related
  354. to troff are shown below.  The remainder of the FAQ list is
  355. devoted to troff; bail out now if you are not interested.
  356.  
  357. --------
  358. Subject: TR2. How many varieties of troff are there? What are the differences?
  359.  
  360. The original Ossanna troff generates proprietary printer
  361. codes for the Wang C/A/T Phototypesetter; we'll call this
  362. "CAT Troff".  This version comes bundled in many systems,
  363. in particular, SunOS, most other Berkeley-derived systems,
  364. and is contained in the Xenix Text Processing package.
  365. The AT&T, BSD and Xenix variants all differ slightly, but not
  366. in any important ways.  CAT troff is useless without filters to
  367. convert the "CAT codes" to something else, especially since the
  368. C/A/T is as common as a California condor.  These filters are
  369. described later.
  370.  
  371. In 1981, Brian Kernighan of Bell Laboratories rewrote
  372. troff to generate a generic typesetting language.
  373. These troffs are called "ditroff" (for device-independent troff) and
  374. contain some additional features such as arbitrary line drawing, and
  375. more flexible font handling.  "Documenter's Workbench" (DWB) is
  376. a package containing ditroff and several other typesetting filters.
  377. | The latest AT&T version is DWB 3.3, which sold as source code;
  378. most commercial binary variants (Elan, SoftQuad, Image Network, etc.)
  379. are based on DWB 2.0.  The Free Software Foundation
  380. distributes a re-engineered version of ditroff called groff.
  381.  
  382. If you have a troff and want to know which it is, type:
  383.     troff < /dev/null > /dev/null
  384. If it responds with "typesetter busy" or "No /dev/cat; use -t or -a",
  385. you have CAT troff, otherwise it's ditroff.  If you get an answer from:
  386.     dwbv
  387. you have the AT&T release 3.0 or later.  The differences are too
  388. numerous and subtle to document here, but the variants are about
  389. 95% compatible.  All are ASCII based, but DWB 3.3 and Groff also
  390. accept ISO 8859-1 (aka Latin 1), the Western European character set.
  391.  
  392. --------
  393. Subject: TR3. What are some of the filters for troff output?
  394.  
  395. Psroff is a suite of programs that allow you to translate CAT
  396. troff output or ditroff output format into PostScript, HP Laserjet
  397. (with incremental font downloading) or ditroff.  See description
  398. of hp2pbm below for driving printers other than these three.
  399.  
  400. Psroff works with all versions of CAT troff and ditroff, including
  401. groff.  Psroff allows you to change fonts on the fly (unlike any other
  402. CAT troff converter).  Psroff has been used to drive HP Laserjet and clone
  403. printers, PostScript (including Display PostScript and Sun Pageview),
  404. X windows previewers (such as xditview and xtroff), Ghostscript and
  405. many others.
  406.  
  407. Psroff comes with a large suite of utility programs that allow you to
  408. create, manipulate, display HP Laserjet and PostScript fonts, as well as
  409. construct width tables for these fonts from a variety of sources, including
  410. TeK PK format, HP SFP, and PostScript.  Psroff also comes with a number of
  411. other utilities, such as PostScript page reordering, Ascii-2-PostScript
  412. converters etc.  Psroff 3.0 is the only troff HP Laserjet filter fully
  413. | supporting scalable fonts or HPGL/2 graphics on HP LJ III printers.
  414.  
  415. Psroff 3.0 is capable of performing some limited emulation of ditroff
  416. features (eg: line drawing) with CAT troff.
  417.  
  418. | Psroff 3.0 is available from comp.sources.unix, volume 24.  Or from
  419. | ftp.uunet.ca, in /distrib/chris_lewis/psroff (fully patched).  Patch
  420. | level 14 is current.  The author is Chris Lewis, clewis@ferret.ocunix.on.ca.
  421.  
  422. Adobe Transcript is a commercial package similar to psroff, in that it
  423. contains filters for converting ditroff or CAT troff.  But only to
  424. PostScript.  It also contains filters for Ascii-2-PostScript, and
  425. is often installed as part of SunOS printcap filters.  Adobe Transcript
  426. contains a user interface script called "psroff" which should not be
  427. confused with the other psroff (but often is).  Information can be
  428. acquired on its availability by contacting Adobe.  Supports psfig
  429. with a little hacking (instructions in psfig release)
  430.  
  431. The groff package from the Free-Software-Foundation includes drivers
  432. for PostScript, DVI, X and constant-width printers, and the complete
  433. suite of troff preprocessors with the exception of grap.  It is available
  434. via anonymous ftp from several sources (it needs the FSF C++ or AT&T
  435. C++ 2.0 compilers to compile, but many binary versions are also available
  436. for FTP).  Supports character kerning (unlike CAT troff or DWB).  Does not
  437. contain an HP Laserjet driver.  A "dvi2lj" or psroff 3.0 can be used as a
  438. HP Laserjet driver for groff.  Groff has made some slight changes
  439. in the ditroff and width table formats, so use with non-groff drivers
  440. may need a little fiddling.  Written by James Clark.  The latest
  441. version is 1.06.  The latest version can always be ftped from
  442. prep.ai.mit.edu:pub/gnu.
  443.  
  444. --------
  445. Subject: TR4. What other troff printer drivers are there?
  446.  
  447.     - thack: CAT to PostScript.   c.s.u. archives.
  448.       For very casual use only.  Has no width tables, and can't,
  449.       for example, make tbl box corners line up.)  Available from
  450.       c.s.u archives.  Very simple to build/install.
  451.  
  452.     - tpscript: ditroff to PostScript (reasonably good filter)
  453.       c.s.u archives.  Does not support psfig.
  454.  
  455.     - jetroff: ditroff to HP Laserjet (no support for III scalable
  456.       fonts).  Commercial version (jetroff 2) no longer available.
  457.       Jetroff 1.0 (shareware) is available from c.s.m archives.
  458.       Author: Rick Richardson.  Would need some fiddling to work
  459.       with groff.
  460.  
  461.     - troff2lj: CAT troff to HP Laserjet.  Limited font handling
  462.       functionality - package discontinued by author when psroff
  463.       2.0 was released.
  464.  
  465.     - lcat/lroff: obsolete, should be junked, precursor to psroff.
  466.  
  467.     - hp2pbm: not a troff-2-something filter per-se.  However,
  468.       given a HP Laserjet driver, hp2pbm can convert HP Laserjet
  469.       codes to Jef Poskanzer's PBM format, which permits you
  470.       to use any of the many output formats supported by PBM.
  471.       Author: Chris Lewis and Klaus Schallhorn.  Hp2pbm and PBM+
  472.       are accessible from c.s.m archives.  Hp2pbm includes a
  473.       24 pin Epson driver and a built-in G3 FAX driver.
  474.  
  475.     - cat2desk is a version of lcat/lroff modified to work with
  476.       Deskjets.  Psroff will work with newer deskjets (especially
  477.       scalable font ones with PCL4), but not older ones (the font
  478.       format is different) which are PCL3.
  479.  
  480. --------
  481. Subject: TR5. How do I get my troff to drive my printer?
  482.  
  483.     a) If you already have CAT troff and you don't need pic or grap:
  484.  
  485.        Your best bet is psroff if you want to drive printers supported
  486.        by psroff (PostScript, HP Laserjet, ditroff filters, PBM+
  487.        supported devices (including Epson 24 pin, FAX).  Transcript
  488.        is an alternative for PostScript output (but doesn't
  489.        allow you to mount fonts, no drawing support).
  490.  
  491.     b) You already have ditroff:
  492.  
  493.        You may already have a driver for your printer.  Check.
  494.        If not, your best bets are jetroff, psroff, tpscript,
  495.        transcript.
  496.  
  497.     c) You don't have a troff or, you have CAT troff and you need pic
  498.        and grap:
  499.  
  500.        Get "a DWB", such as groff (no grap), DWB 3, or one of the
  501.        commercial variants.
  502.  
  503. --------
  504. Subject: TR6. None of the mentioned packages support *my* printer.  Help?
  505.  
  506. This area is not entered into lightly. Look for a commercial
  507. or free package that supports your device.  Failing that, try
  508. to acquire (legally!) the source code for another device and
  509. modify it.  The AT&T documentation "Troff User's Manual" has
  510. a Reference section that completely documents the ditroff
  511. language.  SunOS and Psroff 3.0 documentation contain
  512. descriptions of the CAT troff language.  Psroff 3.0 is
  513. designed for drop-in drivers, and may be the easiest to
  514. extend.  Coupled with hp2pbm, psroff3.0 can probably drive
  515. just about any kind of printer that supports raster graphics
  516. with relatively little trouble (see Epson 24 pin driver for
  517. guidance).
  518.  
  519. If you can get a PostScript driver and are running on current
  520. SunOS, you could consider developing a NeWSprint driver for
  521. your printer. NeWSprint is Sun's NeWS (PostScript language
  522. interpreter extended for driving displays; not the same thing
  523. as "Display PostScript"(tm).  This may be easier than developing
  524. a troff driver, since all NeWSprint really needs is the ability to
  525. send a bitmap to a printer. Source and developer's documentation are
  526. shipped standard with NeWSprint.
  527.  
  528. Thack is ideal for quick hacks with CAT troff for printers that
  529. have dynamically scalable fonts (aside from the fact that thack
  530. has no facilities for building width tables).
  531.  
  532. --------
  533. Subject: TR7. How to I embed PostScript in troff?
  534.  
  535. There are two methods:
  536.  
  537.     - including "absolute" PostScript.  PostScript that knows where
  538.       it goes on the page, and decides its own scaling.
  539.       All versions of ditroff support this one way or another.
  540.       CAT troff does as well when coupled with psroff.  This is
  541.       most often supported by some permutation of \! or \X'...'
  542.       directives.
  543.  
  544.     - including PostScript, automatically scaling and placing the
  545.       image.  This requires that the PostScript be EPS (so that the
  546.       size and origin of the image is accessible).  Groff and
  547.       DWB 3.3 have facilities for including EPS files and automatically
  548.       placing/scaling them on the page, including leaving space in the
  549.       troff text for the image.
  550.  
  551.       Psfig (c.s.u archives) is a troff preprocessor which will permit
  552.       this sort of automatic placement/scaling with an older version
  553.       of ditroff (such as DWB 2.1) as long as the backend printer driver
  554.       understands it.  Psroff 3.0 and Adobe Transcript support psfig with
  555.       ditroff, but only Psroff 3.0 will support psfig with CAT troff.
  556.  
  557. Caution: many PC and MAC graphics packages generate sloppy PostScript which
  558. cannot be gracefully included in other documents.
  559.  
  560. --------
  561. Subject: TR8. What are fonts?  How do I add fonts?
  562.  
  563. A font is a set of characters in an specific typeface.  Unlike
  564. TeX, troff does not consider the same typeface at different
  565. sizes to be different fonts.
  566.  
  567. You have to make the width tables, install them, and tell the
  568. troff filter how to emit/request the fonts.  The details differ
  569. from one package to another.  Check the documentation.
  570.  
  571. --------
  572. Subject: TR9. What are width tables?
  573.  
  574. Both CAT troff and ditroff need to know the width of each character
  575. that you use.  The widths of each character (along with some additional
  576. characteristics) are arranged in a file for each font.  There are
  577. basically five different width table formats:
  578.  
  579.     1) CAT troff: uses a binary table of 224 unsigned chars.
  580.     2) MIPS (and RISC/Ultrix) CAT troff uses an ASCII dump of (1)
  581.     3) DWB 2.x and several of the commercial variants use an ASCII
  582.        format that is compiled into a binary form by a special program
  583.        called "makedev".
  584.     4) DWB 3.x uses the ASCII format mentioned in (3) - doesn't need
  585.        to be compiled.
  586.     5) Groff uses the ASCII format mentioned in (4) with minor variations.
  587.  
  588. If the width tables are wrong, character spacing will look funny - up
  589. to and including overlapping characters, and broken right justification.
  590.  
  591. --------
  592. Subject: TR10. How do I make width tables?
  593.  
  594. Creating them is not hard.  Getting the actual metrics sometimes is.
  595.  
  596. The AT&T documentation "Troff User's Manual" describes the DWB width
  597. table format.  Your DWB may already have a manual page for it.
  598.  
  599. Psroff 3.0 contains documentation on DWB and CAT troff format width
  600. tables.
  601.  
  602. DWB 3.3, Psroff 3.0 and tpscript each have a utility for automatically
  603. creating width tables by sucking the data out of a PostScript device.
  604.  
  605. Psroff 3.0 and jetroff have utilities for creating width tables from
  606. HP laserjet fonts.
  607.  
  608. Psroff 3.0 can convert between any of the 5 width table formats.
  609.  
  610. Consult the documentation to find out where to put the files.
  611.  
  612. --------
  613. Subject: TR11. What are: pic, eqn, tbl, grap, refer?
  614.  
  615. These are the basic troff preprocessors shipped with DWB:
  616.  
  617.     - pic allows you to draw arbitrary line-drawing graphics in a
  618.       machine-independent fashion.
  619.     - eqn allows you to construct mathmatical equations.
  620.     - tbl provides a mechanism for specifying and displaying
  621.       automatically sized/configured tables
  622.     - grap uses pic to construct graphs.
  623.     - refer provides a mechanism for searching for and formatting
  624.       bibligraphic references.
  625.  
  626. Neither pic nor grap are included with CAT troff, but eqn, tbl and
  627. frequently refer are present.  Groff does not at present support grap.
  628.  
  629. --------
  630. Subject: TR12. How do I preview my troff on my screen?
  631.  
  632.     a) X windows: xditview and xtroff (X11R5 contrib directory, xtroff
  633.        also from ftp.cs.toronto.edu) and gxditview (from groff) will
  634.        preview ditroff format (groff requires gxditview), including
  635.        psroff 3.0's ditroff output from CAT troff.
  636.     b) Display PostScript (ie: AIX 3 & DEC dpsexec, NeXT,
  637.        Sun Pageview, Ultrascript): any PostScript generating
  638.        troff.  (Theoretically at least.  May need a teensy bit
  639.        of PostScript hacking to get a reasonable pager (psroff3.0
  640.        has this built in).  Pageview and Ultrascript have some
  641.        limitations so may not work with a specific PostScript
  642.        generator)
  643.     c) Others: You can probably find a PBM converter for it,
  644.        so use a Laserjet-generating troff configuration plus hp2pbm.
  645.        (eg: Sun rasters, 3b1 screens, EGA, VGA, GIFF, TIFF etc.)
  646. |       I preview on X by generating PCL with psroff, converting
  647. |       to PBM with hp2pbm, then display with pbm2Xd (part of hp2pbm)
  648. |       and xwud (part of X windows).
  649.     d) Others: You may be able to find a DVI driver for it,
  650.        so use a DVI-generating troff configuration (namely,
  651.        groff's ditdvi) and use the appropriate dvi2<whatever> filter.
  652.